home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 23 / Amiga Format AFCD23 (Feb 1998, Issue 107).iso / -seriously_amiga- / shareware / programming / other / hunk / hunk.readme < prev    next >
Text File  |  1997-12-01  |  5KB  |  150 lines
  1. Short:    Editor 4 hunk structure of binary files with GUI
  2. Uploader: thor@einstein.math.tu-berlin.de (Thomas Richter)
  3. Author:   thor@einstein.math.tu-berlin.de (Thomas Richter)
  4. Type:     dev/misc
  5. Version:  2.11.1
  6. _____________________________________________________________________________
  7.  
  8.                         The THOR-Software Licence
  9.  
  10.  
  11. This License applies to the computer programs known as "Hunk Processor".
  12. The "Program", below, refers to such program.
  13.  
  14.  
  15. The programs and files in this distribution are freely distributable
  16. under the restrictions stated below, but are also Copyright (c)
  17. Thomas Richter.
  18.  
  19.  
  20. Distribution of the Program by a commercial organization without written
  21. permission from the author to any third party is prohibited if any payment
  22. is made in connection with such distribution, whether directly
  23. (as in payment for a copy of the Program) or indirectly (as in payment
  24. for some service related to the Program, or payment for some product
  25. or service that includes a copy of the Program "without charge";
  26. these are only examples, and not an exhaustive enumeration of prohibited
  27. activities). However, the following methods of distribution involving
  28. payment shall not in and of themselves be a violation of this restriction:
  29.  
  30.  
  31. (i) Posting the Program on a public access information storage and
  32. retrieval service for which a fee is received for retrieving information
  33. (such as an on-line service), provided that the fee is not
  34. content-dependent (i.e., the fee would be the same for retrieving the same
  35. volume of information consisting of random data).
  36.  
  37.  
  38.  
  39. (ii) Distributing the Program on a CD-ROM, provided that the files
  40. containing the Program are reproduced entirely and verbatim on such
  41. CD-ROM, and provided further that all information on such CD-ROM be
  42. redistributable for non-commercial purposes without charge.
  43.  
  44.  
  45.  
  46. Everything in this distribution must be kept together, in original
  47. and unmodified form.
  48.  
  49.  
  50.  
  51.  
  52. Limitations.
  53.  
  54. THE PROGRAM IS PROVIDED TO YOU "AS IS," WITHOUT WARRANTY. THERE IS NO
  55. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  56. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  57. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  58. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  59. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  60. SERVICING, REPAIR OR CORRECTION.
  61.  
  62.  
  63.  
  64. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE ALL FILES CONTAINED IN
  65. THIS ARCHIVE.
  66.  
  67. _____________________________________________________________________________
  68.  
  69. The "Hunk Processor" is a tool for editing the hunk structure of binary
  70. AmigaDOS load files (not object codes that must be linked afterwards, but
  71. complete executable binaries). 
  72.  
  73. Functions:
  74.  
  75.     Add and remove hunks, as well as relocation entries.
  76.     Merge hunks to shorten programs without "crunching".
  77.     Code optimizer to remove unnecessary jumps.
  78.     Rexx interface for automatic operation.
  79.  
  80.  
  81. The "Hunk Processor" is a quiet old program I wrote years ago, so the GUI is
  82. really ugly (this became better with 2.06) - but this is a tool, not a piece 
  83. of artwork. I mostly use to to patch bugs in existing programs, together 
  84. with a standard debugging tool.
  85. The plus of the "Hunk Processor" is that it keeps the relocation data after
  86. loading an executable, so after patching it the "Hunk Processor" can re-
  87. create a loadable program.
  88.  
  89.  
  90. Extras:
  91.     -    A Rexx program that prints out all relocation data.
  92.     -    A Rexx program for automatic replacement of the
  93.         relocation hunks with the more efficient Reloc32Short 
  94.         hunks.
  95.     -    A lot of external "Hunk Optimizers", i.e. "hop" files.
  96.  
  97. To get help about the ARexx interface, lauch "Hunk" from the shell and
  98. send the Arexx command "HELP" to the "HUNK.1" port.
  99.  
  100.  
  101. Due to my lazyness, a guide is missing, too. You're up to yourself using this,
  102. but you should consult me if you are interested in a guide or a manual. Cause
  103. I need some motivation writing a documentation, THE MANUAL WON'T BE FOR FREE. 
  104.  
  105. Write to:
  106. ________
  107.  
  108. Thomas Richter:
  109. EMail:    thor@einstein.math.tu-berlin.de
  110.  
  111. or visit my web site at:
  112. WWW:    http://www.math.tu-berlin.de/~thor/thor/index.html
  113.  
  114.  
  115. On response, I will send you a form how to receive a guide. If I collected
  116. enough requests, I will start writing one.
  117.  
  118.  
  119. _____________________________________________________________________________
  120.  
  121. Changes since 2.11:
  122.     
  123.     Hunk unchanged, but updated the General020 optimizer a bit.
  124.     Replaced the NOP that's patched in by a LEA (A6),A6 to avoid
  125.     pipeline stalls of the 68060 processor.
  126.     Updated the PA.rexx script to run the PowerPacker and to allow
  127.     multiselection.
  128.  
  129. Changes since 2.10:
  130.  
  131.     Fixed another set of bugs in the ARexx interface.
  132.     Added an automatic patch script.
  133.     Added the option to remove trailing zeros.
  134.     Improved the file requester.
  135.     Removed a bug from the file requester.
  136.  
  137. Changes since 2.06:
  138.  
  139.     Removed a bug in the Rexx interface
  140.     Added the external hunk optimizers
  141.     Added the possibility to split the
  142.     relocation data in long and short
  143. _____________________________________________________________________________
  144.  
  145.  
  146. Have fun,
  147.  
  148.         Thomas
  149.  
  150.